.TH k3d 1 "2003" "K-3D Version @VERSION@"
.SH NAME
k3d \- 3d modeling and animation system

.SH SYNOPSIS
.B k3d
[options]

.SH DESCRIPTION
K-3D is a free (as in freedom) 3D modeling, animation, and rendering system 
for GNU/Linux and Win32. K-3D features a robust, object-oriented plugin 
architecture. K-3D is capable of producing motion-picture-quality output when
paired with a RenderMan Interface compliant render engine such as Aqsis.
.PP
.RI "Please visit " "http://k3d.sourceforge.net" " for more information."

.SH OPTIONS
.B -h, --help
.RS
Prints this help information and exits.
.RE

.B --dialogpath 
[path]
.RS
Overrides the path for storing dialog templates (this overrides both defaults and the K3D_DIALOG_TEMPLATES_PATH environment variable, below).
.RE

.B --libpaths
[path]
.RS
Overrides the path(s) for loading plugin libraries (this overrides both defaults and the K3D_LIB_PATHS environment variable, below).
Multiple colon-delimited paths are allowed.  Use "&" as a synonym for the default paths.
.RE

.B --shadersourcepaths
[path]
.RS
Overrides the path(s) for loading shaders (this overrides both defaults and the K3D_SHADER_SOURCE_PATHS environment variable, below).
Multiple colon-delimited paths are allowed.  Use "&" as a synonym for the default paths.
.RE

.B --shadercachepath 
[path]
.RS
Overrides the path where compiled shaders will be cached (this overrides both defaults and the K3D_SHADER_CACHE_PATH environment variable, below).
.RE

.B --sharepath 
[path]
.RS
Overrides the path for loading shared data files (this overrides both defaults and the K3D_SHARE_PATH environment variable, below).
.RE

.B --tutorialspath 
[path]
.RS
Overrides the path for loading interactive tutorials (this overrides both defaults and the K3D_TUTORIALS_PATH environment variable, below).
.RE

.B --optionsfile 
[path]
.RS
Overrides the filepath for storing user options (this overrides both defaults and the K3D_OPTIONS_PATH environment variable, below).
.RE

.B -n, --new
.RS
Creates a new document after startup.
.RE

.B -o, --open 
[file]
.RS
Opens the given file after startup.
.RE

.B --tutorials
.RS
Opens the tutorials menu immediately following startup.
.RE

.B --record-tutorials
.RS
Opens the tutorial recorder immediately following startup.
.RE

.B --script 
[file]
.RS
Play the given script after startup (use - for stdin).
.RE

.B --batch
.RS
Operate in batch (no user intervention) mode.
.RE

.B --gui
[gui type]
.RS
Specifies the type of graphical user interface to display (valid values are "none" or "gtk").
.RE

.B --exit
.RS
Exits the program (useful after running scripts in batch mode).
.RE

.B --show-timestamps
.RS
Prints timestamps next to log messages.
.RE

.B --show-process
.RS
Prints the process name next to log messages.
.RE

.B --color
.RS
Color-codes log messages based on their priority.  Requires an ANSI color-capable terminal.
.RE

.B --syslog
.RS
Logs messages to syslog.
.RE

.B --log-level
[level]
.RS
Specifies the minimum message priority to log (valid values are "warning", "information", or "debug").
.RE

.B --version
.RS
Prints program version information and exits.
.RE

.B --nosplash
.RS
Disables the startup splash screen.
.RE

.B --blackbox 
[file]
.RS
Starts the Black Box Recorder, recording to [file].
.RE

.SH ENVIRONMENT VARIABLES

.B K3D_DIALOG_TEMPLATES_PATH
.RS
Overrides the path for storing dialog templates (this overrides the default, but can be overridden by the --dialogpath option, above).
.RE

.B K3D_LIB_PATHS
.RS
Overrides the path(s) for loading plugin libraries (this overrides the default, but can be overridden by the --libpaths option, above).
Multiple colon-delimited paths are allowed.  Use "&" as a synonym for the default paths.
.RE

.B K3D_SHADER_SOURCE_PATHS
.RS
Overrides the path(s) for loading shaders (this overrides the default, but can be overridden by the --shadersourcepaths option, above).
Multiple colon-delimited paths are allowed.  Use "&" as a synonym for the default paths.
.RE

.B K3D_SHADER_CACHE_PATH
.RS
Overrides the path where compiled shaders are cached (this overrides the default, but can be overridden by the --shadercachepath option, above).
.RE

.B K3D_SHARE_PATH
.RS
Overrides the path for loading shared data files (this overrides the default, but can be overridden by the --sharepath option, above).
.RE

.B K3D_TUTORIALS_PATH
.RS
Overrides the path for loading interactive tutorials (this overrides the default, but can be overridden by the --tutorialspath option, above).
.RE

.B K3D_OPTIONS_PATH
.RS
Overrides the path for storing user options (this overrides the default, but can be overridden by the --optionsfile option, above).
.RE

.SH AUTHORS
Written by Timothy M. Shead <tshead@k-3d.com>, and many others.

.SH REPORTING BUGS
Report bugs to <k3d-development@lists.sourceforge.net>

.SH COPYRIGHT
Copyright (c) 1995-2004, Timothy M. Shead
.br
This software is licensed under the GNU General Public License; see the source for copying conditions.  
There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

.SH SEE ALSO
The full documentation for K-3D is maintained as a DocBook manual at http://k3d.sourceforge.net

